home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Ghostscript / src / scommon.h < prev    next >
Encoding:
C/C++ Source or Header  |  2001-01-01  |  6.0 KB  |  171 lines
  1. /* Copyright (C) 1994, 1996, 1999 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of AFPL Ghostscript.
  4.   
  5.   AFPL Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author or
  6.   distributor accepts any responsibility for the consequences of using it, or
  7.   for whether it serves any particular purpose or works at all, unless he or
  8.   she says so in writing.  Refer to the Aladdin Free Public License (the
  9.   "License") for full details.
  10.   
  11.   Every copy of AFPL Ghostscript must include a copy of the License, normally
  12.   in a plain ASCII text file named PUBLIC.  The License grants you the right
  13.   to copy, modify and redistribute AFPL Ghostscript, but only under certain
  14.   conditions described in the License.  Among other things, the License
  15.   requires that the copyright notice and this notice be preserved on all
  16.   copies.
  17. */
  18.  
  19. /*$Id: scommon.h,v 1.2.2.1 2000/11/02 15:05:08 igorm Exp $ */
  20. /* Definitions common to stream clients and implementors */
  21.  
  22. #ifndef scommon_DEFINED
  23. #  define scommon_DEFINED
  24.  
  25. #include "gsmemory.h"
  26. #include "gstypes.h"        /* for gs_string */
  27. #include "gsstype.h"        /* for extern_st */
  28.  
  29. /*
  30.  * There are three major structures involved in the stream package.
  31.  *
  32.  * A stream is an "object" that owns a buffer, which it uses to implement
  33.  * byte-oriented sequential access in a standard way, and a set of
  34.  * procedures that handle things like buffer refilling.  See stream.h
  35.  * for more information about streams.
  36.  */
  37. #ifndef stream_DEFINED
  38. #  define stream_DEFINED
  39. typedef struct stream_s stream;
  40.  
  41. #endif
  42. /*
  43.  * A stream_state records the state specific to a given variety of stream.
  44.  * The buffer processing function of a stream maintains this state.
  45.  */
  46. typedef struct stream_state_s stream_state;
  47.  
  48. /*
  49.  * A stream_template provides the information needed to create a stream.
  50.  * The client must fill in any needed setup parameters in the appropriate
  51.  * variety of stream_state, and then call the initialization function
  52.  * provided by the template.  See strimpl.h for more information about
  53.  * stream_templates.
  54.  */
  55. typedef struct stream_template_s stream_template;
  56.  
  57. /*
  58.  * The stream package works with bytes, not chars.
  59.  * This is to ensure unsigned representation on all systems.
  60.  * A stream currently can only be read or written, not both.
  61.  * Note also that the read procedure returns an int, not a char or a byte;
  62.  * we use negative values to indicate exceptional conditions.
  63.  * (We cast these values to int explicitly, because some compilers
  64.  * don't do this if the other arm of a conditional is a byte.)
  65.  */
  66. /* End of data */
  67. #define EOFC ((int)(-1))
  68. /* Error */
  69. #define ERRC ((int)(-2))
  70. /* Interrupt */
  71. #define INTC ((int)(-3))
  72. /****** INTC IS NOT USED YET ******/
  73. /* Callout */
  74. #define CALLC ((int)(-4))
  75. #define max_stream_exception 4
  76. /* The following hack is needed for initializing scan_char_array in iscan.c. */
  77. #define stream_exception_repeat(x) x, x, x, x
  78.  
  79. /*
  80.  * Define cursors for reading from or writing into a buffer.
  81.  * We lay them out this way so that we can alias
  82.  * the write pointer and the read limit.
  83.  */
  84. typedef struct stream_cursor_read_s {
  85.     const byte *ptr;
  86.     const byte *limit;
  87.     byte *_skip;
  88. } stream_cursor_read;
  89. typedef struct stream_cursor_write_s {
  90.     const byte *_skip;
  91.     byte *ptr;
  92.     byte *limit;
  93. } stream_cursor_write;
  94. typedef union stream_cursor_s {
  95.     stream_cursor_read r;
  96.     stream_cursor_write w;
  97. } stream_cursor;
  98.  
  99. /*
  100.  * Define the prototype for the procedures known to both the generic
  101.  * stream code and the stream implementations.
  102.  */
  103.  
  104. /* Initialize the stream state (after the client parameters are set). */
  105. #define stream_proc_init(proc)\
  106.   int proc(P1(stream_state *))
  107.  
  108. /* Process a buffer.  See strimpl.h for details. */
  109. #define stream_proc_process(proc)\
  110.   int proc(P4(stream_state *, stream_cursor_read *,\
  111.     stream_cursor_write *, bool))
  112.  
  113. /* Release the stream state when closing. */
  114. #define stream_proc_release(proc)\
  115.   void proc(P1(stream_state *))
  116.  
  117. /* Initialize the client parameters to default values. */
  118. #define stream_proc_set_defaults(proc)\
  119.   void proc(P1(stream_state *))
  120.  
  121. /* Reinitialize any internal stream state.  Note that this does not */
  122. /* affect buffered data.  We declare this as returning an int so that */
  123. /* it can be the same as the init procedure; however, reinit cannot fail. */
  124. #define stream_proc_reinit(proc)\
  125.   int proc(P1(stream_state *))
  126.  
  127. /* Report an error.  Note that this procedure is stored in the state, */
  128. /* not in the main stream structure. */
  129. #define stream_proc_report_error(proc)\
  130.   int proc(P2(stream_state *, const char *))
  131. stream_proc_report_error(s_no_report_error);
  132.  
  133. /*
  134.  * Some types of streams have the ability to read their parameters from
  135.  * a parameter list, and to write all (or only the non-default)
  136.  * parameters to a parameter list.  Since these are not virtual
  137.  * procedures for the stream (they operate on stream_state structures
  138.  * even if no actual stream has been created), we name them differently.
  139.  */
  140. #define stream_state_proc_get_params(proc, state_type)\
  141.   int proc(P3(gs_param_list *plist, const state_type *ss, bool all))
  142. #define stream_state_proc_put_params(proc, state_type)\
  143.   int proc(P2(gs_param_list *plist, state_type *ss))
  144.  
  145. /*
  146.  * Define a generic stream state.  If a processing procedure has no
  147.  * state of its own, it can use stream_state; otherwise, it must
  148.  * create a "subclass".  There is a hack in stream.h to allow the stream
  149.  * itself to serve as the "state" of a couple of heavily used stream types.
  150.  *
  151.  * In order to simplify the structure descriptors for concrete streams,
  152.  * we require that the generic stream state not contain any pointers
  153.  * to garbage-collectable storage.
  154.  */
  155. #define STREAM_MAX_ERROR_STRING 79
  156. #define stream_state_common\
  157.     const stream_template *template;\
  158.     gs_memory_t *memory;\
  159.     stream_proc_report_error((*report_error));\
  160.         int min_left; /* required bytes for lookahead */ \
  161.     char error_string[STREAM_MAX_ERROR_STRING + 1]
  162. struct stream_state_s {
  163.     stream_state_common;
  164. };
  165.  
  166. extern_st(st_stream_state);
  167. #define public_st_stream_state() /* in stream.c */\
  168.   gs_public_st_simple(st_stream_state, stream_state, "stream_state")
  169.  
  170. #endif /* scommon_INCLUDED */
  171.